home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / news / nntp / inn / faq-inn-2 < prev    next >
Encoding:
Text File  |  1993-08-23  |  6.2 KB  |  169 lines
  1. Last Changed: $Id: FAQ-inn.2,v 1.11 1993/08/17 18:14:37 tal Exp $
  2.  
  3. This is a separate guide to installing INN.  It is written for INN 1.4,
  4. but should work on any version.  It is written and maintained by Norman
  5. J.  Pieniazek (norman@giardia.pdb.cdc.gov).  Please send updates and
  6. corrections to him.
  7.  
  8.  
  9.  
  10. INSTALLATION AND MAINTENANCE OF INN 1.4
  11.  
  12.  
  13. I. INSTALLATION
  14.  
  15.  
  16.  
  17. 1. Get: inn1.4.tar.Z from ftp.uu.net (192.48.96.9).  This file is in
  18.    the directory: /networking/news/nntp/inn
  19.  
  20. 2. Get: patch.tar.Z from ftp.uu.net.  This file is in the directory /pub.
  21.    Compile and install patch in the directory: /usr/local/bin.
  22.  
  23. 3. If you don't have any gnu software, ftp to aeneas.mit.edu (18.71.0.38), go to directory
  24.    /pub/gnu and get the following files.
  25.  
  26.    fgrep        current version: fgrep-1.1
  27.    gawk            current version: gawk-2.15.2
  28.    gcc            current version: gcc-2.4.2
  29.    grep            current version: grep-1.6
  30.    make            current version: make-3.65
  31.    sed            current version: sed-1.14
  32.  
  33. Compile and install these programs starting with make and gcc.  Some
  34. people have reported problems with gnu sed 2.02.  If people want to
  35. help me maintain a list of which GNU replacements are required on
  36. certain OS's, please send me the data.  I'll keep the list up to date.
  37.  
  38. 4. Get perl-4.0.36.tar.gz from ftp.uu.net - directory: /archive/systems/gnu.
  39.    Compile and install in /usr/bin.
  40.  
  41. 5. As root, create directories:    /usr/local/inn (this is your $INN directory)
  42.                 /usr/local/news
  43.                 /news/bin
  44.                 /news/lib
  45.  
  46. 6. Move inn1.4.tar.Z to $INN.  Change directory to $INN  
  47.    Type: "zcat inn1.4.tar.Z | tar xvf -".  This will install
  48.    inn files for compilation.
  49.  
  50. 7. Change directory to $INN/config and follow the instructions
  51.    in R. Salz's INN nstallation manual.  At least, change
  52.    the compiler from cc to gcc. (If you have Solaris 2.1 - see changes
  53.    made to the config files in Daniel Rich's letter).
  54.  
  55. 8. Change directory to $INN.  Type: "make world install".
  56.  
  57. 9. If you get no fatal errors from make, check the /usr/local/news
  58.    directory for history* files.  Remove or rename them.  Go back
  59.    to the $INN directory and type: "BUILD" to run the final
  60.    installation script.
  61.  
  62. 10. Get: /networking/news/nntp/inn/tutorial.Z from ftp.uu.net
  63.     Follow instructions to set up at least your newsfeeds, hosts.nntp,
  64.     and nnrp.access files.  Get the active file from your newsfeed and
  65.     edit it to your taste. Remember to include the control and junk
  66.     newsgroups.
  67.  
  68. 11. Type: "/usr/bin/perl /usr/local/news/bin/inncheck" and correct
  69.     any errors reported by inncheck.
  70.  
  71. 12. Type: "sh /usr/local/etc/rc.news".  Look in syslog
  72.     for any errors.  Type: "ps -aux" and check, if innd owner
  73.     is news.
  74.  
  75. 13. In /etc/aliases create an entry: "usenet: <you, or root>". 
  76.     Reboot, change directory to /var/yp, type: "make".  From the same
  77.     directory, type: "/usr/etc/yp/ypinit -m".  Restart innd (see #12).
  78.  
  79. 14. Type: "/bin/crontab -e news" and insert the following line:
  80.     40 23 * * * /usr/local/news/bin/news.daily delayrm
  81. if you are using overchan (in newsfeeds):
  82.     40 23 * * * /usr/local/news/bin/news.daily delayrm expireover
  83.  
  84. 15. Run tests from your machine to the server (your machine at telnet
  85.     port 119).  See Tom Limoncelli's manual for details.
  86.  
  87. 16. After completing the test, be sure to delete the entry for your
  88.     machine from the hosts.nntp file.  If you will not do it, your
  89.     machine will be treated as a "feeder" and not as a "reader".
  90.  
  91. 17. Watch the news.daily reports in your mail for any
  92.     additional errors.
  93.  
  94. 18. Adding new groups - see Part II, Section 2.b, or:
  95.     a. Type: "ctlinnd pause 'edit active'"
  96.     b. Edit the active file.  Format is: groupname himark lomark flag.
  97.        Set himark to 0000000000 and lomark to 0000000001.
  98.     c. Run inncheck (see #11) to check the new active file for errors.    
  99.     d. Type: "ctlinnd reload active 'new active'".
  100.     e. Type: "ctlinnd go 'edit active'".
  101.  
  102. 19. Set posting. 
  103.      a. Edit the /usr/local/news/newsfeeds file and add:
  104.     <alias for your feed>/<full address of feed\
  105.         :*\    (for all local postings)
  106.         :Tf,Wnm:    (standard entry)
  107.      b. Edit /usr/local/news/nntpsend.ctl file and add:
  108.         <alias for your feed>:<full address of feed>::-T1800 -t300
  109.      c. Type: "/bin/crontab -e news" and insert a line:
  110.     0,10,20,30,40,50 * * * * /usr/local/news/bin/nntpsend
  111.      d. Run inncheck (see #11).
  112.      e. Post to misc.test and include reply in the Subject line,
  113.         automatic responses will be mailed to usenet (see 13) within
  114.         a few minutes.
  115.  
  116. 20. To start innd automatically at bootup, include at the end of
  117.     your rc.local the following lines:
  118.  
  119.     #
  120.     # Start INN news service - Internet News Daemon (innd)
  121.     #
  122.     if [ -f /usr/local/etc/rc.news ]; then
  123.            /usr/local/etc/rc.news; echo "Starting INN news service"
  124.     fi
  125.  
  126.   
  127.  
  128. II. MAINTENANCE
  129.  
  130. 1. Newgroups are sometimes added automatically through a control message.
  131.    A mail message to usenet will alert to such an automatic change
  132.    to the active file.  If you do not want to subscribe to a news group,
  133.    change directory to /usr/local/news and type:
  134.    
  135.     ctlinnd rmgroup xx.xxx.xx
  136.  
  137. 2. Sometimes, a mail message will arrive for usenet with a checkgroups
  138.    file.  Remove header, save the body of the message in:
  139.    
  140.    /usr/local/news/bin/control/news_control/news_control_todaysdate
  141.    
  142.    cd to that directory and type:
  143.    "../docheckgroups <news_control_todaysdate >todaysdate_pre"
  144.    
  145.    Read the output file (todaysdate_pre) and carry out all the instructions
  146.    that you think pertain to your situation.  You will have to change
  147.    directory to /usr/local/news and:
  148.     
  149.     a. remove some discontinued groups:
  150.         type: "ctlinnd rmgroup xx.xxx.xxxx"
  151.  
  152.     b. add a group:
  153.         type: "ctlinnd newgroup xx.xxx.xxxx flag ''"
  154.  
  155.     c. mark a group correctly:
  156.         type: "ctlinnd changegroup xx.xxx.xxxx flag"
  157.  
  158.   Run inncheck and repeat the docheckgroups command:
  159.    "../docheckgroups <news_control_todaysdate >todaysdate_after"
  160.    Check for any problems.  
  161.  
  162.    Also, edit the /usr/local/news/newsgroups file to reflect any
  163.    changes you introduced.
  164.  
  165. 3. IMPORTANT!!! Never run fsck on the drive where the /spool/news
  166.    files are located.  Innd has a lot of active disk I/O going on
  167.    and fsck will show a lot of errors.  Use ctlinnd to throttle,
  168.    pause, or shotdown innd - see the manual page for ctlinnd.
  169.